home *** CD-ROM | disk | FTP | other *** search
/ 130 MIDI Tool Box / 130 MIDI Tool Box.iso / cmv14 / cmv.doc < prev    next >
Text File  |  1992-06-20  |  19KB  |  456 lines
  1.  
  2.  
  3.  
  4.                             CALLIOPE MUSIC VISION
  5.                             -=-=-=-=-=-=-=-=-=-=-
  6.              Copyright (c) 1992 Melvin Douglas All Rights Reserved
  7.                         Single-Track Midi Music Player
  8.                                    for the
  9.                            Sound Blaster Sound Card
  10.                             Version 1.4 July 1992
  11.                                   Shareware
  12.  
  13.  
  14. -----------
  15. LEGAL STUFF:
  16. -----------
  17.  
  18.     CALLIOPE MUSIC VISION software is hereafter referred to as CALLIOPE.
  19.  
  20.     Users of CALLIOPE must accept this disclaimer of warranty:
  21.  
  22.     "CALLIOPE  is  supplied as is.   The author disclaims  all  warranties,
  23.     expressed or implied, including, without limitation,  the warranties of
  24.     merchantability and of fitness for any purpose.   The author assumes no
  25.     liability for damages,  direct or consequential,  which may result from
  26.     the use of CALLIOPE."
  27.  
  28.     CALLIOPE is a "shareware program"  and is provided at no charge to  the
  29.     user  for evaluation.   Feel free to share it with your  friends,   but
  30.     please do not give it away altered or as part of another system.    The
  31.     essence  of "user-supported"  software is to provide personal  computer
  32.     users  with quality software without high prices,  and yet  to  provide
  33.     incentive for programmers to continue to develop new products.   If you
  34.     find  this  program  useful and find that you are  using  CALLIOPE  and
  35.     continue to use CALLIOPE after a 21 day trial period,  you must make  a
  36.     registration payment of $20.00 U.S Dollars.
  37.  
  38.        To register this copy, print and complete the REGISTER.FRM file
  39.        and send it along with the registration fee of $20 directly to:
  40.  
  41.                            Melvin Douglas
  42.                            Post Office Box 141
  43.                            Uniondale, New York
  44.                            11553-0141
  45.  
  46.     Adlib is a registered trademark of Adlib inc.
  47.     Sound Blaster is a registered trademark of Creative Labs Inc.
  48.     QuickBasic is a registered trademark of Microsoft Corp.
  49.  
  50.                PROGRAM FILES:
  51.                -------------
  52.                CMV.EXE       - Calliope program
  53.                CMV.DOC       - Calliope documentation
  54.                ROL2MIDI.EXE  - Conversion utility program
  55.                REGISTER.FRM  - Registration form
  56.                FILE_ID.DIZ   - BBS file description text
  57.                VENDOR.DOC    - Vendor distribution agreement
  58.                *.MDI         - several pre-converted midi music files
  59.  
  60. Note: A music file with the extension ".ROL" is an Adlib format sound file.
  61. ".ROL"   files may be found on almost any Bulletin Board system or  may  be
  62. purchased from many of the shareware distributors.
  63.  
  64. In  case you don't read any further,  note that you may use any key on  the
  65. command  line  as a switch to bypass the opening screen:  i.e.,   "CMV  X".
  66.  
  67. ------------------
  68. ABOUT THIS PROGRAM:
  69. ------------------
  70.  
  71. Thank you for trying CALLIOPE MUSIC VISION (CMV).  This program was created
  72. for use with a Sound Blaster sound board.   It will play single track  Midi
  73. compatible music files.  Included with CALLIOPE is a program (ROL2MIDI.EXE)
  74. which  allows  you  to easily convert a .ROL file into  a  Midi  compatible
  75. (.MDI) file, which is a type 0 midi.   CALLIOPE IS NOT CRIPPLED IN ANY WAY.
  76.  
  77. To convert any .ROL file to MIDI format, do the following:
  78.  
  79.    C>ROL2MIDI filename /Bbankfile /Onewfile
  80.  
  81.    for example, to convert ROCKNROL.ROL to ROCKNROL.MDI using the
  82.    STANDARD instrument bankfile: (.ROL files require Instrument bank files)
  83.  
  84.    C>ROL2MIDI rocknrol.rol /Bstandard.bnk /Orocknrol.mdi
  85.  
  86.    Note: Case is sensitive.
  87.  
  88. The  resulting  file is the only format that CALLIOPE  will  recognize  and
  89. play.   MDI files do not require Bank (.BNK)  or instrument files once they
  90. have been converted from their .ROL format into single track Midi's.    All
  91. of  the  musical information is self contained in a  single  compact  file.
  92.  
  93. Several  pre-converted  files are included so that you may  experience  the
  94. "Sight and Sound" of CALLIOPE immediately.  Simply copy all of the CALLIOPE
  95. files  into  a  separate  directory  and  type  CMV  (then  press   ENTER).
  96.  
  97. ---------------------
  98. HARDWARE REQUIREMENTS:
  99. ---------------------
  100.  
  101.     o  An IBM PC/XT/AT/386/486 or true "compatible" running
  102.        MS-DOS or PC-DOS 3.0 or later.
  103.  
  104.     o  528K System Memory.
  105.  
  106.     o  CGA/EGA/VGA Video Adaptor.
  107.        Note that screen activity may be sluggish on a CGA equipped
  108.        XT systems.
  109.  
  110.     o  One floppy disk drive or hard drive.
  111.  
  112.     o  A Sound Blaster Sound board.
  113.  
  114. ----------
  115. BACKGROUND:
  116. ----------
  117.  
  118. Like  many  others before me,  when I first purchased my  sound  board,   I
  119. rediscovered all of my old games which supported sound, and seemingly my PC
  120. was  a whole new thing again.   Then,  I became interested in  the  board's
  121. ability to play music (or simulate playing music).
  122.  
  123. Most of the available music players were good, but I found that I wanted to
  124. know more about the music that was playing...not just the filename and it's
  125. size.    I  also  wanted a display that was  dynamic  rather  than  static,
  126. something  that presented me with lots of information,  and I  wanted  more
  127. control of the file selection process too.
  128.  
  129. But there were so many music formats...rol's, mid's, mod's, cmf's and more.
  130. For some reason "Midi"  music appealed to me,  but programs that play  Midi
  131. music  were  mostly  for  multiple track Midi's  (.MID  files  -  Type  1).
  132.  
  133. Single  track  Midi's (.MDI - Type 0)  can be created  from  existing  .ROL
  134. files.   There must be a "bizillion" rol files in the world, so this format
  135. already   has   a   large  base  of  available   music   to   support   it.
  136.  
  137. Those are some of the reasons CALLIOPE was created.   Here is a list of the
  138. features that CALLIOPE will provide.   I hope you like them well enough  to
  139. make CALLIOPE your favorite Music Player.
  140.  
  141. --------
  142. FEATURES:
  143. --------
  144.  
  145.  
  146.   File Selection Via a Popup scrolling window, plus:
  147.   --------------------------------------------------
  148.  
  149.   -  Sort files by Name, Size or Date.
  150.   -  Tag or un-tag single files or ALL files.
  151.   -  Support for 1000 files.
  152.  
  153.   A Play-Mode screen which provides the following information:
  154.   -----------------------------------------------------------
  155.  
  156.   -  Shows the amount of available conventional memory. (Refreshed
  157.      after each song is completed).
  158.   -  The I/O port address and IRQ location of your sound board.
  159.   -  Name of the current directory and or sub-directory.
  160.   -  Name of the music currently playing displayed in a scrolling panel.
  161.   -  Name of the next three music files that you have selected.
  162.   -  The total number of selections that you have made.
  163.   -  The number of selections remaining to be played.
  164.   -  The number of the current selection.
  165.   -  The elapsed time for the current selection.
  166.   -  The ESTIMATED time for all remaining songs to be played.
  167.   -  The status of AutoReplay toggle.
  168.  
  169.      Note that the word estimated is emphasized.  Time estimates are
  170.      based on an average-bytes-per-minute and readjust for each new song.
  171.      It may be off by plus or minus 5 minutes (or more).  It's only an
  172.      estimate.  Also note that all number counts STOP during a REPLAY and
  173.      continue when regular play is resummed.
  174.  
  175.   File Buffer Information:
  176.   -----------------------
  177.  
  178.   -  The current size of the buffer.
  179.   -  The byte currently being processed in the buffer (ascending).
  180.   -  The percentage of the buffer already processed.
  181.   -  The mode of the current music: MELODIC or PERCUSSIVE.
  182.  
  183.   A Status window to advise you of any changes:
  184.   --------------------------------------------
  185.   -  The Status Window will keep you advised of program changes/errors.
  186.   -  In addtion, the lower portion of the Status Window will advise you
  187.      if AutoReplay is active or not, since it is a delayed command.
  188.   -  Plus various symbols to provide an alternate measure of music duration.
  189.   -  A pointer-bar graphic across the top row for estimating the music
  190.      duration from a distance.  Admittedly, some of these are redundant,
  191.      but,.... so what?
  192.  
  193.   Active Play Controls are as follows:
  194.   -----------------------------------
  195.  
  196.   -  Pause the music.
  197.   -  Continue music from a paused state.
  198.   -  Skip the current music (immediate).
  199.   -  Interrupt music and Replay the CURRENT song.
  200.   -  Invoke a delayed interruption causing the current song to replay
  201.      upon its completion.  This is a TOGGLE command, and may be reversed.
  202.   -  Cancel music play mode and return to the Main Menu.
  203.   -  Cancel music play mode and return to the File Selection Window.
  204.   -  While in the REPLAY screen, Pause, Continue and Exit are available.
  205.  
  206. -----------------
  207. CALLIOPE COMMANDS:
  208. -----------------
  209.  
  210. I  tried to make CALLIOPE as intuitive as possible so that you can  use  it
  211. "right out of the box".   However,  all software should contain at least  a
  212. brief   explanation   of   the  available  commands,   so   here   it   is:
  213.  
  214. When  CALLIOPE is first invoked,  the file selection window will popup  and
  215. search the current directory for all files with an extension of .MDI,   and
  216. will  present  a list of these files within this window.   If  no  matching
  217. files  are  found,  CALLIOPE will notify you of this via  a  popup  message
  218. window,   allowing you to return to the DOS prompt.   While the  files  are
  219. displayed, you may scroll the window up or down to view, select or deselect
  220. files. Selected files are marked with a Musical Note symbol for easy recog-
  221. nition.
  222.  
  223. After a while you will get bored with the opening screen, so......
  224.  
  225. COMMAND LINE:  You may use any key as a command line switch in order to
  226.                bypass the opening screen.  For instance, "CMV x", where
  227.                "x" may be any letter or number.
  228.  
  229. ---------------------
  230. FILE SELECTION WINDOW:
  231. ---------------------
  232.  
  233. The File Selection Window will automatically pop-up upon first invocation
  234. of the program.  On slower machines, this may take a second or two.  Other-
  235. wise, you may activate the File Selection Window by type Alt-M.
  236.  
  237. -------------------------------
  238. FILE (MUSIC) SELECTION COMMANDS:
  239. -------------------------------
  240.  
  241. NOTE:  YOU MUST "TAG" A FILE IN ORDER TO PLAY IT.
  242.  
  243. Tag  one file at a time by pressing the  RIGHT ARROW key, or <Shift> RIGHT
  244. ARROW key.   Unshifted,  the highlighted bar will move down one file  after
  245. each tag.   Shifted,  it will move up one file.  Un-tag is exactly the same
  246. except using the LEFT ARROW key.
  247.  
  248. <Num  Lock> will produce the same effect as <Shift> Left or  Right  arrows.
  249.  
  250. Tag  all files using (Ctrl> RIGHT ARROW,  and un-tag all files with  <Ctrl>
  251. LEFT ARROW.
  252.  
  253. Pressing RETURN after selecting files will immediately begin the Play  mode
  254. and music will start.  If you press Escape after making a selection(s), the
  255. selected files will be abandoned and you will be returned to the main menu.
  256.  
  257. Additionally, if you press RETURN without selecting any files, you will be
  258. returned to the main menu.
  259.  
  260. ----------
  261. SORT FILES:
  262. ----------
  263.  
  264. Sorting is easy, just pick a number (as follows):
  265.  
  266.     1 = Sort by filename.
  267.     2 = Sort by file size.
  268.     3 = Sort by file date.
  269.  
  270.  
  271.           During Music Play, the following commands are available:
  272.           -------------------------------------------------------
  273.  
  274. -------------
  275. PAUSE Command: (P)
  276. -------------
  277.  
  278. Pressing  "P"  will temporarily PAUSE the current music.   While  PAUSE  is
  279. active,   the  CONTINUE command is highlighted and other commands  will  be
  280. visually de-emphasized.   The elapsed time display will be blocked however,
  281. the time will continue to count-down in the background.
  282.  
  283. NOTE:  Occasionally, when you select the PAUSE command, it may get stuck on
  284. a note that refuses to be silent.  If this happens, use the "C"  command to
  285. CONTINUE  and  then use the "P"  command again until the sound  fades  out.
  286.  
  287. ----------------
  288. CONTINUE Command: (C)
  289. ----------------
  290.  
  291. Pressing "C"  will CONTINUE music, or reverse a PAUSE command. Music will
  292. resume playing from the point that it was PAUSED.
  293.  
  294. ------------
  295. SKIP Command: (S)
  296. ------------
  297.  
  298. Pressing "S" will terminate the current music and will play the next music
  299. in the queue immediately.  You may also use this command to move to the next
  300. song if the current song gets "stuck" or just stops playing (probably a cor-
  301. rupt file). Skip is not available during REPLAY.
  302.  
  303. The term "skip" in this instance  means that  the music was aborted during
  304. play rather than actually "skipped over" before being heard.
  305.  
  306.  
  307. --------------
  308. REPLAY Command: (R)
  309. --------------
  310.  
  311. Pressing  "R"  will instantly REPLAY the current music.   The program  will
  312. bring you to the INSTANT REPLAY screen,  and you will have the  opportunity
  313. to  Pause/Continue the REPLAY as you do in regular play mode.   You  cannot
  314. select the REPLAY Command (R)  if AutoREPLAY (A)  is currently active.   If
  315. you do, the word "C O N F L I C T" will quickly flash in the Status Window.
  316. This is to remind you that you have already requested a delayed REPLAY  for
  317. the  current selection.   If you must hear the music again NOW,  then  just
  318. press "A"  to deactivate AutoREPLAY and then press "R"  for REPLAY.   Watch
  319. the "Completed" status in the Buffer Window.  When the three "+++"  symbols
  320. are  red,   then  you  don't have much time left  for  a  REPLAY  decision.
  321.  
  322. After using Calliope for a while, you will find that the pointer bar graph
  323. at the top of the screen will be your most watched reference.
  324.  
  325. Note that if you decide to Exit the Replay screen,  you will be returned to
  326. the Main Menu, and any unheard selections will be lost.   The assumption is
  327. that you really want to hear a REPLAY and would not want to "Skip" it.   Of
  328. course  you  still have the choce of PAUSING it in case your  phone  rings.
  329.  
  330. ------------------
  331. AUTOREPLAY Command: (A)
  332. ------------------
  333.  
  334. Pressing "A"  will invoke the AutoREPALY Mode.   In this mode,  the current
  335. song  is "flagged"  for REPLAY upon it's completion in regular  play  mode.
  336. While the song is playing,  you may cancel or reinvoke AutoREPLAY as  often
  337. as you wish by simply press "A".
  338.  
  339. Pressing  "A"  will toggle AutoREPLAY to an ON or OFF state.   You will  be
  340. advised  of  it's current status on the bottom line of the  Status  Window.
  341. All  of the same conditions found in the REPLAY screen apply here as  well.
  342.  
  343. ---------------------------
  344. FILE WINDOW  [EXIT] Command: (F)
  345. ---------------------------
  346.  
  347. Pressing "F" will terminate CALLIOPE's music play mode and return you to to
  348. the  FILE SELECTION WINDOW where you may select more songs to play or  exit
  349. to the Main Menu.
  350.  
  351. ------------
  352. EXIT Command: (X)
  353. ------------
  354.  
  355. Pressing  "X"  will shut down CALLIOPE's music play mode and return you  to
  356. the  main menu.   On the other hand,  when the last song has  been  played,
  357. CALLIOPE will exit the Play Mode and return you to the main menu.   At that
  358. point   the,   the  File  Selection  Window  will   pop-up   automatically.
  359.  
  360. -------------------
  361. ENDING THE PROGRAM: (ESC)
  362. -------------------
  363.  
  364. Pressing  ESCape from the main menu will terminate CALLIOPE and return  you
  365. to the DOS prompt (assuming the File Selection Window was not active).   If
  366. the File Selection Window is active, pressing ESCape 3 times will  terminate
  367. CALLIOPE, and return you to the DOS prompt while displaying a low key share-
  368. ware screen and session statistics.
  369.  
  370. ------
  371. ERRORS:
  372. ------
  373.  
  374. If  a music file gets stuck at it's termination point and attempts to  loop
  375. itself and start over, CMV will force it to terminate, and will display the
  376. message "filename was PUSHED" in the status window.  "PUSHED"  means it was
  377. forced  off  of the queue by the Calliope Police who constantly  watch  for
  378. this sort of behavior.
  379.  
  380.                              Some important notes:
  381.  
  382.  o  If the length of your path is exceedingly long, it could conceivably
  383.     overwrite the elapsed time area of the screen.
  384.  
  385.  o  All graphics are text based and therefore do not require a VGA monitor.
  386.     However, the program was created on a system with a VGA monitor.
  387.  
  388.  o  EMS is not supported in this version, but it may be introduced in a
  389.     future version as the program grows larger and more memory is required.
  390.  
  391.  o  A music file larger that 65,520K will force an error condition, in
  392.     which case you will be returned to the main menu (hopefully).
  393.  
  394.  o  CMV was created on a 386 16Mhz system, running DOS 5.0 with 640k
  395.     memory.  The sound card was a Sound Blaster v1.5 (original).
  396.     Programming language: QuickBasic version 4.5
  397.  
  398.  o  Sometimes when a music file suddenly stops playing, it may be corrupt.
  399.     Reconvert it from your original .ROL file and try again.
  400.  
  401.                             Version History
  402.  
  403.     Version 1.0  = Initial 'closed distribution' release. (no uploads).
  404.     Version 1.1  = Added bar graph/new screens. Ensure file size within limits.
  405.     Version 1.2  = Bug fix and reduced memory usage. Official release.
  406.     Version 1.3  = Added "F" command to access File Window from Play Mode.
  407.     Version 1.4  = Music Queue now displays the next 3 songs in the Queue.
  408.                    Added "Estimated Time" (minutes) for all songs to play.
  409.                    Enhanced error checking while each song plays.
  410.                    Removed the limited mouse support.
  411.                    "Any key" will now bypass the opening screen.
  412.                    Added "R" for Instant Replay.
  413.                    Added "A" for delayed automatic Replay.
  414.                    Added various corrective/functional/cosmetic screen updates.
  415.                    Additional stats upon exit from the program.
  416.  
  417.     The latest version of CMV and other great files can always be found
  418.     on the following outstanding U. S. A. bulletin boards:
  419.     ---------------------------------------------------------------------
  420.                 1 -  The Executive Network BBS, New York
  421.                      914-667-4684 all baud speeds
  422.     ---------------------------------------------------------------------
  423.  
  424.                 2 -  The Invention Factory, New York
  425.                      212-431-1254
  426.  
  427.                 3 -  Digital Zero, New York
  428.                      212-353-8415
  429.  
  430.                 4 -  Computer Connection, Washington, D.C.
  431.                      202-543-8088
  432.  
  433.                 5  - Vernon Buerg's BBS, Calif.
  434.                      707-778-8944
  435.  
  436.                 6  - Gene Plant's BBS, Illinois
  437.                      708-843-8664
  438.  
  439.                 7  - The SoundBlaster Digest BBS, Toronto
  440.                      416-840-2485
  441.  
  442.                 Special Thanks to Ro and Joe Malacria.
  443.   ...and Executive Network BBS, the BEST international bulletin board.
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.